ποΈGitΠ―ΡΠ°ποΈ
Node / meshtastic / Meshtastic-Android / files / .github / agents / speckit.brownfield.validate.agent.md
.github/agents/speckit.brownfield.validate.agent.md fix/metrics-lazycolumn-duplicate-key-crash (55432cff) Text, 4.14 KB
description: Verify bootstrap output matches actual project structure and conventions
<!-- Extension: brownfield -->
<!-- Config: .specify/extensions/brownfield/ -->
Validate Bootstrap
Verify that the spec-kit configuration generated by T383838/speckit.brownfield.bootstrap accurately reflects the actual project structure, conventions, and architecture. Reports mismatches and suggests corrections.
User Input
T282828
$ARGUMENTS
You MUST consider the user input before proceeding (if not empty). The user may specify a focus area (e.g., "only constitution", "only templates") or request verbose output.
Prerequisites
1. Verify a spec-kit project exists by checking for T383838.specify/ directory
2. Verify git is available and the project is a git repository
3. Verify at least one bootstrap artifact exists (constitution, customized templates, or AGENTS.md)
Outline
1. Validate constitution: Check T383838.specify/memory/constitution.md against the actual codebase:
ββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Check β How β
ββββββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Language references β Verify mentioned languages actually exist in the codebase β
β Directory references β Verify all referenced paths (T383838client/, T383838server/, etc.) exist β
β Framework references β Verify mentioned frameworks are in dependency files β
β Naming conventions β Sample 20 files and check if naming rules match reality β
β Test location β Verify test directories mentioned in constitution exist β
β Branch pattern β Check if branch naming rules match actual branches in T383838git branch -a β
ββββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
2. Validate templates: Check customized spec/plan/tasks templates:
βββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Check β How β
βββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Module references β Verify template sections reference actual modules/directories β
β Test commands β Verify test commands in tasks template actually work β
β Build commands β Verify build commands reference real scripts from package files β
β Section relevance β Flag template sections that reference non-existent project aspects β
βββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
3. Validate AGENTS.md (if exists): Check agent configuration:
βββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Check β How β
βββββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Directory ownership β Verify each agent's directories exist β
β No overlaps β Check that no directory is owned by multiple agents β
β No orphans β Check that all source directories are covered by at least one agent β
βββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
4. Detect drift: Check if the project has changed since bootstrap:
β’ New directories or modules added since constitution was generated
β’ Dependencies added or removed since bootstrap
β’ New branch patterns that don't match constitution rules
5. Output validation report:
T282828
# Validation Report
## Constitution
| Rule | Status | Detail |
|------|--------|--------|
| Primary language: TypeScript | β
Pass | 68% of source files |
| Frontend in Ta5d6ff`client/` | β
Pass | Directory exists, contains React code |
| Backend in Ta5d6ff`server/` | β
Pass | Directory exists, contains FastAPI code |
| Test location: Ta5d6ff`__tests__/` | β οΈ Drift | Also found tests in Ta5d6ff`tests/` (not mentioned) |
| Branch pattern: Ta5d6ff`feat/*` | β
Pass | 8/10 recent branches match |
## Templates
| Template | Status | Detail |
|----------|--------|--------|
| Spec template | β
Pass | All custom sections map to real project aspects |
| Plan template | β οΈ Drift | References Ta5d6ff`shared/` module β directory renamed to Ta5d6ff`common/` |
| Tasks template | β
Pass | Test commands verified |
## Summary
Tff7b72- **Checks passed**: 9/11
Tff7b72- **Drift detected**: 2 items
Tff7b72- **Action needed**: Update plan template (Ta5d6ff`shared/` β Ta5d6ff`common/`), add Ta5d6ff`tests/` to constitution
Rules
β’ Read-only β this command never modifies any files
β’ Evidence-based β every pass/fail must cite specific files or directories as evidence
β’ Actionable output β for every failure or drift, suggest the specific fix
β’ Non-blocking β drift warnings don't mean the configuration is broken, just that it could be improved
β’ Respect .gitignore β never scan ignored directories when validating
Served by rngit 1.5.2 - Generated in 0.11s